home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / dev / c / CLib-SDI.lha / CLib-SDI / CLib-SDI.readme next >
Text File  |  2002-10-27  |  3KB  |  70 lines
  1. Short:    V1.1 example.library in 100% C code
  2. Type:     dev/c
  3. Uploader: stoecker@epost.de (Dirk Stoecker)
  4. Author:   Dirk Stoecker, lots of other people
  5.  
  6. example.library V1.1 (26.09.2002)
  7. An Amiga shared library in 100 % C language - coming with sources.
  8.  
  9. Supported and tested compilers:
  10. SAS/C 6.5x, MaxonC (HiSoftC) 3.x, MaxonCPP 4.x, StormC 3.x, GCC 2.7.2.1,
  11. vbcc 0.8
  12.  
  13. This example library code is partly based on CLib37x by Andreas R. Kleinert.
  14. The main stuff comes from my own library startup code developed for
  15. xpkmaster.library and xadmaster.library.
  16.  
  17. I decided to release my own code to show a somewhat different method.
  18. Some of the texts are taken from Andreas release. Best is to check both
  19. ways and choose the one you like most (or mix them :-).
  20.  
  21. Thanks must go to: Andreas R. Kleinert for the initial idea in 1996.
  22. Gunter Nikl for developing the main SDI_compiler.h stuff and for telling
  23. me lots of improvements and bug fixes. All the others contributing to
  24. Andreas release.
  25.  
  26. This sample library intends to make Amiga shared library sources compileable
  27. with any available Amiga C compiler - without any changes to the source code.
  28.  
  29. This seams to be easily done: nearly any noticeable compiler for the Amiga
  30. does support generation of libraries by special linker commands and pre-
  31. generated object files.
  32.  
  33. But when looking into the details, one will find out, that these linker
  34. functionality just reduces the influence of the programmer on how his sources
  35. are handled, that the pre-generated object files just originally were done
  36. in Assembler, and that each compiler does define its own interface definitions
  37. and usage rules.
  38.  
  39. But as a programmer, it is important to have control over the _complete_
  40. source code and to be able to compile it _anywhere_ with only minor changes,
  41. even better without any changes.
  42.  
  43. Since most Amiga system modules - noticeable Libraries, Devices and Resources -
  44. do have startup-modules and other larger parts completely written in Assembler
  45. language, the most important task for getting inter-compiler and operating
  46. system independant sources in my opinion is, to completely migrate the
  47. interfaces to C language.
  48.  
  49. If you can submit adjustments for the other compilers as mentioned above: feel
  50. free to send these. Feel free to use this source for own projects.
  51.  
  52. History:
  53.   1.0  first version, Made with help of CLib by Andreas Kleinert and my
  54.        library code used in xadmaster.library.
  55.   1.1  Updated the library to compile with MorphOS and allow tests of callback
  56.        hooks.
  57.  
  58. Please contact me:
  59.  
  60. *********************************************************************
  61. * snail-mail:                  * e-mail:                            *
  62. *   Dirk Stoecker              *   stoecker@epost.de                *
  63. *   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
  64. *   01877 Bischofswerda        * world wide web:                    *
  65. *   GERMANY                    *   http://www.dstoecker.de/         *
  66. * phone:                       * pgp key:                           *
  67. *   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
  68. *********************************************************************
  69.  
  70.